Carbon


PBMakeFSSpecSync

Header: Files.h Carbon status: Supported

Creates an FSSpec structure for a file or directory.

OSErr PBMakeFSSpecSync (
    HParmBlkPtr paramBlock
);
Parameter descriptions
paramBlock

A pointer to a basic HFS parameter block.

function result

A result code. If the specified volume is mounted and the specified parent directory exists, but the target file or directory doesn’t exist in that location, PBMakeFSSpecSync fills in the structure and returns fnfErr instead of noErr. The structure is valid, but it describes a target that doesn’t exist. You can use the structure for another operation, such as creating a file.

PBMakeFSSpecSync can return a number of different File Manager error codes. When PBMakeFSSpecSync returns any result other than noErr or fnfErr, all fields of the resulting FSSpec structure are set to 0.

DISCUSSION

The relevant fields of the parameter block are:

Given a complete specification for a file or directory, the PBMakeFSSpecSync function fills in an FSSpec structure that identifies the file or directory.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)